home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3dm / audio / alGetConfig.z / alGetConfig
Encoding:
Text File  |  1998-10-20  |  5.9 KB  |  133 lines
  1.  
  2.  
  3.  
  4. aaaallllGGGGeeeettttCCCCoooonnnnffffiiiigggg((((3333ddddmmmm))))                                              aaaallllGGGGeeeettttCCCCoooonnnnffffiiiigggg((((3333ddddmmmm))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      alGetConfig, alSetConfig - get/set the AAAALLLLccccoooonnnnffffiiiigggg of an audio AAAALLLLppppoooorrrrtttt
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ddddmmmmeeeeddddiiiiaaaa////aaaauuuuddddiiiioooo....hhhh>>>>
  13.  
  14.      AAAALLLLccccoooonnnnffffiiiigggg aaaallllGGGGeeeettttCCCCoooonnnnffffiiiigggg((((AAAALLLLppppoooorrrrtttt ppppoooorrrrtttt))))
  15.      iiiinnnntttt aaaallllSSSSeeeettttCCCCoooonnnnffffiiiigggg((((AAAALLLLppppoooorrrrtttt ppppoooorrrrtttt,,,, AAAALLLLccccoooonnnnffffiiiigggg ccccoooonnnnffffiiiigggg))))
  16.  
  17. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRR
  18.      _p_o_r_t     expects an AAAALLLLppppoooorrrrtttt, the returned value of an aaaallllOOOOppppeeeennnnPPPPoooorrrrtttt((((3333ddddmmmm))))
  19.               call.
  20.  
  21.      _c_o_n_f_i_g   expects an AAAALLLLccccoooonnnnffffiiiigggg, the returned value of a call to
  22.               aaaallllNNNNeeeewwwwCCCCoooonnnnffffiiiigggg((((3333ddddmmmm)))) or aaaallllGGGGeeeettttCCCCoooonnnnffffiiiigggg.
  23.  
  24. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  25.      aaaallllGGGGeeeettttCCCCoooonnnnffffiiiigggg leaves _p_o_r_t unchanged, but returns an AAAALLLLccccoooonnnnffffiiiigggg structure
  26.      initialized to the configuration values of the audio port.  aaaallllFFFFrrrreeeeeeeeCCCCoooonnnnffffiiiigggg
  27.      should be called when the returned AAAALLLLccccoooonnnnffffiiiigggg is no longer needed.
  28.  
  29.      aaaallllSSSSeeeettttCCCCoooonnnnffffiiiigggg attempts to change the configuration of the audio port, _p_o_r_t,
  30.      to match that described by the AAAALLLLccccoooonnnnffffiiiigggg structure, _c_o_n_f_i_g.
  31.  
  32.      AAAALLLLccccoooonnnnffffiiiigggg structures contain information which specifies configuration
  33.      options for a port such as queue size, sample width, and number of
  34.      channels.
  35.  
  36. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  37.      When aaaallllGGGGeeeettttCCCCoooonnnnffffiiiigggg fails, it returns a null-valued AAAALLLLccccoooonnnnffffiiiigggg.
  38.  
  39.      aaaallllGGGGeeeettttCCCCoooonnnnffffiiiigggg can fail for the following reasons:
  40.  
  41.      AAAALLLL____BBBBAAAADDDD____PPPPOOOORRRRTTTT         _p_o_r_t is either invalid or null.
  42.  
  43.      AAAALLLL____BBBBAAAADDDD____OOOOUUUUTTTT____OOOOFFFF____MMMMEEEEMMMM   insufficient memory is available to allocate the
  44.                          AAAALLLLccccoooonnnnffffiiiigggg structure.
  45.  
  46.      Upon successful completion, aaaallllSSSSeeeettttCCCCoooonnnnffffiiiigggg returns 0. Otherwise, aaaallllSSSSeeeettttCCCCoooonnnnffffiiiigggg
  47.      returns -1 and sets an error number which can be retrieved using
  48.      oooosssseeeerrrrrrrroooorrrr((((3333CCCC)))).
  49.  
  50.      aaaallllSSSSeeeettttCCCCoooonnnnffffiiiigggg can fail for the following reasons:
  51.  
  52.      AAAALLLL____BBBBAAAADDDD____PPPPOOOORRRRTTTT       _p_o_r_t is either invalid or null.
  53.  
  54.      AAAALLLL____BBBBAAAADDDD____CCCCOOOONNNNFFFFIIIIGGGG     _c_o_n_f_i_g is either invalid or null.
  55.  
  56.      AAAALLLL____BBBBAAAADDDD____DDDDEEEEVVVVIIIICCCCEEEE     _p_o_r_t and _c_o_n_f_i_g have conflicting device settings.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. aaaallllGGGGeeeettttCCCCoooonnnnffffiiiigggg((((3333ddddmmmm))))                                              aaaallllGGGGeeeettttCCCCoooonnnnffffiiiigggg((((3333ddddmmmm))))
  71.  
  72.  
  73.  
  74.      AAAALLLL____BBBBAAAADDDD____QQQQSSSSIIIIZZZZEEEE      _p_o_r_t and _c_o_n_f_i_g have conflicting values for queue size.
  75.  
  76.      AAAALLLL____BBBBAAAADDDD____CCCCHHHHAAAANNNNNNNNEEEELLLLSSSS   _p_o_r_t and _c_o_n_f_i_g have conflicting number of channels.
  77.  
  78. NNNNOOOOTTTTEEEE
  79.      The device, queue size, and the number of channels of a port are static
  80.      attributes; they cannot be changed once a port is opened.
  81.       If you attempt to change any of these values, aaaallllSSSSeeeettttCCCCoooonnnnffffiiiigggg will fail.
  82.  
  83. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  84.      alFreeConfig(3dm), alNewConfig(3dm), alSetQueueSize(3dm),
  85.      alSetWidth(3dm), alSetChannels(3dm), alSetDevice(3dm), oserror(3C)
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.